home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d26 / gradebk.arc / README.DOC < prev    next >
Text File  |  1990-06-26  |  13KB  |  293 lines
  1.  
  2.                           Magic Gradebook Manager
  3.                           Shareware Version  3.05
  4.                  (c) Copyright 1990 by Charles F. Monroe
  5.                             All Rights Reserved
  6.  
  7.                               Documentation
  8.  
  9.                             PROGRAM BACKGROUND
  10.  
  11. The original version of this program won First Place in the Third Annual
  12. Great Computer Challenge Teacher Programming Contest, April 1987, sponsored
  13. by WHRO Consortium for Interactive Instruction, 5200 Hampton Blvd.,
  14. Norfolk, VA 23508, and Old Dominion University.  It was programmed by
  15. Charles F. Monroe, Computer Math Teacher, Ferguson High School, Newport
  16. News, VA.
  17.  
  18. Magic Gradebook Manager is designed by a teacher who needed a good,
  19. flexible, and affordable computerized gradebook management system.
  20.  
  21. The current version of this program was written in Turbo Pascal 5.5.
  22. Its source code is entirely written by the teacher programmer, including
  23. the interrupt handlers.
  24.  
  25. The program is menu driven and designed to be "user friendly" with
  26. on-line, context-sensitive help screens available from four menus
  27. and while editing the gradebook using the full-screen, spreadsheet-
  28. style gradebook editor, called the "edit grid".
  29.  
  30.                                 DISCLAIMER
  31.  
  32. The programmer specifically disclaims responsibility for any loss of data,
  33. or any other kind of loss, financial or otherwise, due to use or misuse of
  34. the Magic Gradebook Manager program.  You use this program at your own
  35. risk!
  36.  
  37.                          CONFIGURATION REQUIREMENTS:
  38.  
  39.    Computer:          IBM PC or Compatible
  40.    Operating system:  PC-DOS or MS-DOS, versions 2.0 or higher
  41.                       (version 3.0 or higher recommended for print spooling),
  42.    Disk drives:       Two 360K disk drives or a hard disk
  43.    Memory:            256K or more
  44.    Printer:           IBM Proprinter, IBM Graphics Printer,
  45.                       Panasonic KX-P1080i, or their compatibles
  46.                       C. Itoh ProWriter
  47.                       Customizable to any other printer
  48.    Monitor:           Color, or Non-color
  49.    Monitor Adaptor:   Color Graphics Adapter or Monochrome Adapter
  50.                       EGA and VGA
  51.  
  52.  
  53. Magic Gradebook Manager Manual                                    Page 2
  54.  
  55.                               FILES INCLUDED
  56.  
  57.      GRADEBK.EXE   { the compiled, ready-to-run gradebook program }
  58.      GRADEBK.OVR   { program's overlay file                       }
  59.      GBHELP30.DAT  { on-line help data file                       }
  60.      README.DOC    { documentation                                }
  61.      GRADING.DOC   { documentation explaining MGM's method of
  62.                      grade computation                            }
  63.      SAMPLE        { a sample data file whose password is PASS    }
  64.  
  65.                       HOW TO PRINT A COPY OF THIS MANUAL
  66.  
  67.      From the DOS prompt, type
  68.  
  69.      A>copy readme.doc prn  [Enter]
  70.  
  71.  
  72.                      HOW TO RUN MAGIC GRADEBOOK MANAGER
  73.  
  74.      From the DOS prompt, type
  75.  
  76.      A>gradebk [Enter]
  77.  
  78.      If you don't have a color monitor, but your computer has a Color
  79.      Graphics Adapter, type
  80.  
  81.      A>gradebk -bw [Enter]
  82.  
  83.            This will force MGM to start up in black and white instead
  84.            of the color you can't see with your monitor anyway.
  85.  
  86.      To force MGM to start up in color, type
  87.  
  88.      A>gradebk -c [Enter]
  89.  
  90.      If your computer has a Monochrome Adapter, MGM will know it and
  91.      always start up in black and white.
  92.  
  93.  
  94.             WHAT MAGIC GRADEBOOK MANAGER KNOWS ABOUT DISK DRIVES
  95.  
  96.      When MGM is run from Drive A, it always checks to see if a formatted
  97.      diskette has been inserted in Drive B.  If it finds one, it changes
  98.      the default drive to B and expects data files to be loaded from there.
  99.  
  100.      In any other drive, MGM doesn't check drive B and doesn't change
  101.      the default drive.
  102.  
  103.      When MGM terminates, it always returns to the original drive.
  104.  
  105. Magic Gradebook Manager Manual                                    Page 3
  106.  
  107.  
  108.                   MAGIC GRADEBOOK MANAGER'S HELP FILE
  109.  
  110.      All the information needed for the Help Windows to work while using
  111.      Magic Gradebook Manager, are contained in the file GBHELP30.DAT
  112.      supplied on your Program Diskette.
  113.  
  114.      MGM always expects this help file to be located in the original
  115.      drive and directory.  So it's a good idea to place a copy of
  116.      GRADEBK.EXE, GRADEBK.OVR and GBHELP30.DAT in the same drive and
  117.      directory and always start from there to run the program.
  118.  
  119.  
  120.           HOW TO INSTALL MAGIC GRADEBOOK MANAGER ON A HARD DISK
  121.  
  122.      First, change to the directory on drive C where you wish to place
  123.      your Magic Gradebook Manager Program.  If you don't have a directory
  124.      ready, you'll have to create one.  If you don't know how, see
  125.      your DOS Manual or your local computer expert.
  126.  
  127.      Then place your Magic Gradebook Manager Program Diskette in Drive A,
  128.      and type:
  129.  
  130.      A>copy a:*.*  [Enter]
  131.  
  132.      DOS will do the rest!  You can now run the program as described
  133.      previously in this manual.  There's no copy protection, so everything
  134.      should run smoothly.
  135.  
  136.  
  137.                                PASSWORDS
  138.  
  139.      If you forget your password for a file, there is one master
  140.      password that will "unlock" any file.  It is "GBF1.0UNLOCK".
  141.      Using this master password lets you use the file and changes
  142.      the password to "PASS" the next time you use the file IF you
  143.      save it.
  144.  
  145.  
  146.  
  147. Magic Gradebook Manager Manual                                    Page 4
  148.  
  149.                   EDITING FEATURES NOT MENTIONED IN "HELP"
  150.  
  151.       1.  While entering grades from the edit grid, you may type an "E"
  152.           (for "excused") and after pressing Enter, it will immediately
  153.           be changed to an asterisk (*).  You may type a "Z" and after
  154.           pressing Enter, it will immediately be changed to a zero (0).
  155.  
  156.       2.  If you hit the "=" key while editing, whether shifted or not,
  157.           a "+" results.
  158.  
  159.                                   NOTES
  160.  
  161.       1.  This version of MGM will not read data files created by
  162.           versions 1.x.  If you have a significant amount of data
  163.           that you find necessary to convert to the new file format,
  164.           you may contact the programmer at the address on the last
  165.           page for a free file conversion utility.
  166.  
  167.       2.  At several points in the program, you have the option of saving
  168.           certain information to disk for future use.  This data is stored
  169.           in files in the same drive and directory as GRADEBK.EXE as
  170.           follows:
  171.  
  172.             MGMCONF.DAT    Saves any changes to the file mask,
  173.                              Time Out number, and the Auto Save Number
  174.             MGMPRN.DAT     Saves your custom printer codes
  175.             MGMSCALE.DAT   Saves a custom set of grading scale values
  176.             MGMLVAL.DAT    Saves a custom set of letter grade values
  177.             MGMCAL.DAT     Saves a snapshot of the calendar setup
  178.  
  179.       3.  You may install print spooling by using the DOS PRINT command
  180.           prior to running the program--like this:
  181.  
  182.           A>PRINT /D:LPT1 [Enter]
  183.  
  184.           Please, please see your DOS manual for details about this
  185.           command.  It allows you to adjust the printing speed as
  186.           well as the number of files that can be spooled at once.
  187.           Using the above command defaults to printing for 2 computer
  188.           clock ticks out of every 8 with a maximum of 10 files spooled.
  189.  
  190.           Once print spooling is installed, Magic Gradebook Manager will
  191.           automatically spool all reports printed, unless you turn spooling
  192.           off using the Spooler Activate Switch on the Printer Setup Menu
  193.           (this switch appears only if spooling is installed).  NO MORE
  194.           WAITING FOR THE PRINTER TO FINISH!
  195.  
  196.  
  197. Magic Gradebook Manager Manual                                    Page 5
  198.  
  199.           Note:  (1) You can interrupt the print spooler (in case of a
  200.                      printer emergency) by pressing Ctrl C or Ctrl Break.
  201.  
  202.                  (2) If DOS's PRINT is active, but you don't want print
  203.                      spooling, you can disable it with the parameter
  204.                      NOSPOOL at the command line:  A>GRADEBK -NOSPOOL
  205.  
  206.                  (3) Turning the spooler off using the Spooler Activate
  207.                      Switch is recommended for printing short individual
  208.                      reports because DOS's print spooler issues a form
  209.                      feed at the end of every file it prints.
  210.  
  211.                  (4) You must use DOS version 3.0 or higher for the
  212.                      print spooler to work.  DOS version 2.x has a
  213.                      print spooler, but has no provision for programs
  214.                      like MGM to access it.
  215.  
  216.       4.  When assigning class rank, exact ties get the same rank.
  217.           Non-tied ranks are numbered as usual.  Thus, if two people are
  218.           tied for rank 1, the third person would be ranked 3 and rank 2
  219.           would be skipped.
  220.  
  221.       5.  Percent averages are rounded to the nearest tenth.  Letter grade
  222.           averages are computed to eleven significant digits.
  223.  
  224. Magic Gradebook Manager Manual                                    Page 6
  225.  
  226.                             LICENSE AGREEMENT
  227.  
  228. Because of enthusiastic user response and ever-widening acceptance of
  229. Magic Gradebook Manager as a practical and reliable means of using the
  230. computer to manage grades, the current version is offered as Shareware
  231. to insure it availability, and continued development into "The best
  232. little gradebook program you ever had."
  233.  
  234. The License Agreement for Magic Gradebook Manager comes in two forms--
  235. one for individuals and the other for school building sites.
  236.  
  237.                             Individual License
  238.  
  239.                                    $20
  240.  
  241. Individuals remitting the Individual Registration Shareware Fee are
  242. Registered Users, and as such are entitled to unlimited personal use of
  243. the program, user-support, notification of future upgrades, and upgrade
  244. discounts. Each individual may make as many personal copies of the program
  245. as necessary for personal use, including backup and archival copies, as
  246. well as additional copies for school or home use.  Each individual is also
  247. free to give copies of the program away provided that there is NO CHARGE
  248. for doing so.  An exception would be users groups, who may charge a nominal
  249. fee for shipping and handling of software.
  250.  
  251.                         School Building Site License
  252.  
  253.                       $65 per school building site plus
  254.                       $2  for each person using the program
  255.  
  256. A school remitting the School Building Site Registration Shareware Fee
  257. is entitled to distribute copies of Magic Gradebook Manager and its
  258. supporting files, as listed above under FILES INCLUDED, to each person,
  259. teacher or not, who is an employee of that particular school and works in
  260. the building owned by or directly used by the school, provided that person
  261. is listed in a letter or other document accompanying the Shareware Fee and
  262. provided that the Shareware Fee includes the additional amount required for
  263. each person that is to use the software.  Any individuals not correctly
  264. included in such a list would need to register separately as individual
  265. users.  The school and each listed individual is considered a Registered
  266. User, and is entitled to unlimited individual use of the program, user-
  267. support, notification of future upgrades, and upgrade discounts.
  268.  
  269.  
  270. Magic Gradebook Manager Manual                                    Page 7
  271.  
  272. All persons are encouraged to distribute copies to others, but they
  273. should let them know my shareware policy.  (Thank you.)
  274.  
  275. It is understood that a School Building Site IS NOT a school district,
  276. unless that school district has only one school building site.  Each
  277. elementary school, middle school or junior high school, and high school
  278. within a school district is considered a separate building site, and a
  279. School Building Site Registration Shareware Fee would need to be remitted
  280. for each.
  281.  
  282. All Shareware fees should be remitted by check or money order to:
  283.  
  284.                           Charles F. Monroe
  285.                           351 Ft. Worth Ave., #203
  286.                           Norfolk, VA 23505
  287.  
  288. Again, thank you for very much.  And may Magic Gradebook Manager free you
  289. of the dread of grade averaging and provide you with another fine tool to
  290. help you provide the very best instruction you possibly can for the many
  291. young minds who deserve your very best!
  292.  
  293.